From 8cc74c39114528578c4f618a7f40d7f417218a58 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Sat, 11 Jun 2005 05:51:55 +0000 Subject: [PATCH] More docs provided by Owen Taylor. 2005-06-11 Matthias Clasen * gtk/gtkwidget.c (gtk_widget_set_app_paintable): More docs provided by Owen Taylor. --- ChangeLog | 3 +++ ChangeLog.pre-2-10 | 3 +++ ChangeLog.pre-2-8 | 3 +++ gtk/gtkwidget.c | 12 +++++++++--- 4 files changed, 18 insertions(+), 3 deletions(-) diff --git a/ChangeLog b/ChangeLog index f07b8112b2..0e051a47d0 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,8 @@ 2005-06-11 Matthias Clasen + * gtk/gtkwidget.c (gtk_widget_set_app_paintable): More docs + provided by Owen Taylor. + * gtk/gtk.symbols: * gtk/gtkiconview.h: * gtk/gtkiconview.c (gtk_icon_view_get_visible_range): diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10 index f07b8112b2..0e051a47d0 100644 --- a/ChangeLog.pre-2-10 +++ b/ChangeLog.pre-2-10 @@ -1,5 +1,8 @@ 2005-06-11 Matthias Clasen + * gtk/gtkwidget.c (gtk_widget_set_app_paintable): More docs + provided by Owen Taylor. + * gtk/gtk.symbols: * gtk/gtkiconview.h: * gtk/gtkiconview.c (gtk_icon_view_get_visible_range): diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8 index f07b8112b2..0e051a47d0 100644 --- a/ChangeLog.pre-2-8 +++ b/ChangeLog.pre-2-8 @@ -1,5 +1,8 @@ 2005-06-11 Matthias Clasen + * gtk/gtkwidget.c (gtk_widget_set_app_paintable): More docs + provided by Owen Taylor. + * gtk/gtk.symbols: * gtk/gtkiconview.h: * gtk/gtkiconview.c (gtk_icon_view_get_visible_range): diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c index d61046eb09..2006789230 100644 --- a/gtk/gtkwidget.c +++ b/gtk/gtkwidget.c @@ -4270,9 +4270,15 @@ gtk_widget_set_state (GtkWidget *widget, * @widget: a #GtkWidget * @app_paintable: %TRUE if the application will paint on the widget * - * Sets the app-paintable property to indicate to the widget that the - * application intends to paint directly on the widget. - * + * Sets whether the application intends to draw on the widget in + * an ::expose-event handler. + * + * This is a hint to the widget and does not affect the behavior of + * the GTK+ core; many widgets ignore this flag entirely. For widgets + * that do pay attention to the flag, such as #GtkEventBox and #GtkWindow, + * the effect is to suppress default themed drawing of the widget's + * background. (Children of the widget will still be drawn.) The application + * is then entirely responsible for drawing the widget background. **/ void gtk_widget_set_app_paintable (GtkWidget *widget, -- 2.30.2